Subject: Changes to AD draft

From: "Chung-Huy Chen (254-4827 T/L 444)" <[email-masked]>
Date: Thu, 20 May 93 11:43:17 EDT

CIW NB SIG,

Thanks to your contributions to the Level 2 proposal, we have successfully
achieved the first status AD.  However, several clarifications and
improvements have been identified as follows.  Please send your comments
to "[email-masked]".

   (1) Accept_Incoming returns CM_NON_BLOCKING_LEVEL_MISMATCH.

       The send-receive mode characteristic (either half-duplex or
       full-duplex) can be determined for the accepting program only
       when the Accept_Incoming call has completed.  If the program
       have already successfully issued a Set_Processing_Mode call,
       applicable only for a half-duplex conversation, but the
       incoming conversation startup request is for a full-duplex
       conversation, the subsequent Accept_Incoming call will still
       accept the conversation startup request, but change
       non-blocking support for the conversation from conversation-
       level to queue-level and return CM_NON_BLOCKING_LEVEL_MISMATCH
       to the program.

   (2) Allocate and Accept queues have been defined.

       Similar to (1), the program sets processing mode for the
       Send-Receive queue (to which Accept_Incoming has an affinity
       on a half-duplex conversation) while an incoming conversation
       startup request is for a full-duplex conversation (on which
       the Receive queue is defined), or vice verse.  To overcome
       this problem, the Accept_Incoming call now has an affinity
       to the Accept queue which is common to both half-duplex
       and full-duplex conversations.

       The Allocate queue is introduced such that the program
       can set the deallocate_type, error_direction, log_data,
       prepare_to_receive_type, receive_type, and send_type
       characteristics while an Allocate call operation is
       outstanding.  In addition, when a call operation is
       outstanding on the Send or Send-Receive queue, setting
       the following characteristics will receive CM_PROGRAM_
       STATE_CHECK immediately (as opposed to CM_OPERATION_
       NOT_ACCEPTED): security_*, conversation_type, send_
       receive_mode, partner_LU_name, return_control, sync_
       level, and TP_name.

       The Allocate and Accept queues exist only in conversation
       initiation time (i.e., Initialize/Initialize-Incoming state).
       When a conversation has been successfully established,
       they no longer exist, and calls that have an affinity to
       either queue will be processed like those don't have an
       affinity to any queue.

   (3) Processing mode or callback function can be set for only
       those queues that are defined for the effective send-receive
       mode.  If the program tries to do otherwise, it will receive
       a CM_PROGRAM_PARAMETER_CHECK return code.

       For example, after CMINIT completes successfully, the
       conversation is in Initialize state.  The send-receive
       mode characteristic has a default value of "half-duplex."
       The program can set the processing mode for the Send-Receive
       queue, but not for the Send or Receive queue.  The reverse
       situation applies if the program has set the send-receive mode
       to "full-duplex."

       However, the send-receive mode does not have a defined
       value in Initialize-Incoming state.  In this case, the
       program can only set the processing mode for the Accept
       queue.

   (4) completed_op_ID_list has been changed to completed_op_
       index_list

       completed_op_index_list contains indexes, each of them
       referring to the position of an OOID in the outstanding_op_
       ID_list parameter.  By returning the index, the program
       doesn't have to compare the returned OOID and the ones in
       outstanding_op_ID_list to locate its position and replace
       it with a null value.

Following activities have been planned for the SIG:

     -5/26  AP draft available on the ibmstandards machine
            Please download "CIW-NB PS" as a binary file and
            "CIW-NB FIG" as a plain text file.

     -6/9   Please bring your comments to the SIG meeting,
            if they are not distributed before this date.

     -6/11  Request AP at SIG activity report time

Chung-Huy Chen
NB SIG coordinator